QCheckers
Copyright Theo Brinkman (c) 1999, 2000
v1.6.1 - 06-05-2000

Table of Contents:
i:	License
ii:	Intructions
iii:	Installation
iv:	The Source
v:	Change History
vi:	Contact Information
vii:	Credits

License:
- GNU General Public License (Current Version) See 'COPYING.TXT' for details.

Instructions:
- 1. Tap to select a checker
- 2. Tap to select where to move the checker
- 3. Pass game to other player
- 4. Repeat Steps 1 - 3 until someone wins

Installation:
- Install QCheckers.prc and QCheckersPDB.prc on your PalmOS device.
- Optionally, also install the two database files if you want the same settings I had last.
- A full installation will take approximately 23K of space on your palm.

The Source:
- The PocketC Source code for QCheckers is included in a memo pad export file named 'QCheckers-1.6.1-src.mpa'.  Follow your normal import process to add these memos to your PalmOS device.
- The required CControls library can be found from the PocketC web site (http://www.orbworks.com/).
- Please feel free to make changes to the source code and send them in.  I'll add a Credits section to this file with your name and what patch/enhancement you sent in.

Change History:
  v1.0.0  -- 12-29-1999

  v1.0.1  -- 12-30-1999
	   - Removed beeping on checker & move selection

  v1.1.0  -- 01-09-2000
	   - Added 'Undo Last Move'

  v1.1.1  -- 01-09-2000
	   - fixed player change on unhandled graffiti stroke

  v1.2.0a -- 01-11-2000
           - began implementation of a basic form and menu
           - finished a MASSIVE code reorganization and clean up
           - managed to squeeze a bit more speed out of the code
           - added a selection indicator around selected piece

          -- Known Bugs and Unimplemented Features:
           - still at least one case where the selection indicator is not cleared when it should be, which leaves a spare selection indicator around a piece until it is either moved or jumped.
           - 'Done' button doesn't do anything yet.
           - most of the menu just echos the selection in a pop-up message box

  v1.5.1  -- 01-20-2000
	   - Added Options dialog & Config database code
	   - Fixed selection indicator bug.  Gets cleared on undo.
	   - Implemented a few more buttons
	   - Squeezed a bit more speed out of the code at the expense of a bit of memory (four 16x16 bitmaps)
	   - Improved the look of the checkers.

          -- Known Bugs and Unimplemented Features:
	   - 'Done' button still doesn't do anything yet.
	   - Still haven't implemented 'Save...' or 'Load...'
	   - Still not displaying the current Scores

  v1.6.0  -- 03-22-2000
	   - Fixed the selection indicator bug.
	   - Fixed the 'end game on non-control-or-board pen event' bug
	   - MenuHack Compatible (I think)

	  -- Known Bugs and Unimplemented Features:
	   - Menus seem to have broken with the latest version of the PocketC Compiler.  In the process of getting this checked out.
	   - 'Done' button STILL doesn't do anything yet.
	   - STILL haven't implemented 'Save...' or 'Load...'
	   - Still not displaying the current Scores.

  v1.6.0a -- 05-25-2000
	   - Replaced QCheckers.prc with working non-alpha version.
	   - Updated the Source to reflect the changes made.

	  -- Known Bugs and Unimplemented Features:
	   - Menus still broken, haven't figured that one out yet.
	   - 'Done' button STILL doesn't do anythign yet.
	   - STILL haven't implemented 'Save...' or 'Load...'
	   - STILL not displaying the current Scores.

  v1.6.1 -- 06-05-2000
	  - Fix the Menus (Thanks Vilmos)
	  - Fixed errors in Installation section.
	  - 'Undo' button now reflects 'Allow Undo' setting.

  v1.7.0 -- IN PROGRESS
	  - Maintaining game state on exit.  (50% Completed)

  v2.0.0 -- ON HOLD
	  - Adding Menu (started implementation in v1.2.0)
	  - Adding Double/Multi-Jumping
            - will use the 'Done' button to end turn
<DONE!>   x Adding Configuration screen <Started in v1.5.0>
	    x player type (human/computer)
	    x starting player (White/Black/Random)
	    x number of rows of checkers (1/2/3)
	    x allow Undo?
	    x allow Double-/Multi-Jumping? (option exists, un handled)
<DONE!>	    x Adding Default Config DB
	    x dbwritex format is "ccccc"
	      x char p2type; 0=computer, 1=human
	      x char start; 0=player0, 1=player1, 2=random
	      x char rows; 0=1 row, 1=2 rows, 2=3 rows
	      x char allowundo; 0=No, 1=Yes
	      x char allowmulit; 0=No, 1=Yes
	  - Adding Save/Load game
	    - So far DB format (LEN=170 Bytes) is:
	      - char Name[31];  Name of Saved Game
	      - char GameConfig[5]; Config of Saved Game
	      - char Board[64]; Current Game Board
	      - char oBoard[64]; Last Turn's Game Board
	      - char Checkers[2]; # of checkers left for each player
	      - char canundo; is undo allowed?
	      - char index; space of piece currently chosen
	      - char newindex; space currently chosen to move TOd
	      - char player; current player turn

Contact Information:
- Send Enhancements/Patches to faelan@crosswinds.net with 'Checkers Patch' in the subject.
- Mail suggestions to faelan@crosswinds.net with 'Checkers Suggestion' in the subject.
- Random flames and/or abuse will be strictly ignored.

Credits:
Theo Brinkman - Everything not otherwise mentioned.
Vilmos - Found the bug that broke the menus.
